Administration Settings
Database Backed Variforms
Database Backed Variforms view
The Database Backed Variforms view displays the variform overrides that exist in a user's scope view tree. However, you can only update variform overrides at your broadest scope level, which is the scope level at which the user was created. For more information on scoping, including a graphic that illustrates the underlying concepts, see Scoped objects in N4 (on page 1).
One reason for creating a variform override would be to secure individual fields on a form, for example in the N4 Mobile programs (for more information, see Choose which fields appear in N4 Mobile forms (on page 1)). Another reason would be to add your own dynamic custom actions, or to make minor modifications to a table or form definition.
When creating a new variform definition, you can:
Write code from scratch.
Copy code from an existing form or table, and then modify as needed. To do this:
In a form, click the Info button in the lower left, and then copy-paste the code from the Form Info form.
In a table view, click Display Info, and then copy-paste the code from the Table Info form.
Create code using the XML Stub Generator. To do this:
In the Session Factory view, right-click the respective entity and select one of the following:
Generate TABLE XML Stub
Generate FORM XML Stub
Generate Metafield XML Stub
Copy-paste the code from the VARIFORM form and modify as needed.
Extend an existing form or table using the extend attribute.
For more information, see Extending forms and tables (on page 1).
You can use the Actions menu to:
Override a Variform Object (on page 1): Create a new form to override a single variform at a selected scope level, if there is no overridden definition for that variform for the selected scope.
Reload All Variforms: Propagate the changes to one or all nodes. N4 prompts you to select whether to apply the changes to the current node or all nodes. Select Only update local node (default) if you want to test the changes locally before propagating the changes to all nodes. Select Propagate changes to all nodes if you are ready to distribute the changes to all nodes in the cluster.
In addition, you can override variforms by customizing individual table views (on page 1).
You can add, edit, and delete variform overrides from this view.
It is not possible to sort on the Variforms IDs column. Sorting for the CLOB (Character Large Object) data type is not supported at this time.
To be able to override variforms, you need the CUSTOMIZE_UI privilege.
For more information on variforms and their elements, see the N4 SDK documentation available in the Content portal on Salesforce.com.
Notes
You cannot override eventXXX fields. Such fields are legacy fields. Instead, you need to use the respective evntXXX field. You can search for the correct field name in the Metafield Diagnostics for UI Tier view or the Metafield Diagnostics for Business Tier view. For example, to display the Responsible Party field in the Edit Unit Events form, you need to add the field evntResponsibleParty (not the field eventResponsibleParty).
N4 does not support scoping objects at the yard level. The lowest scoping level is the facility.
You can only override a variform once.
For troubleshooting, if a dynamic field in a form does not update, make sure you have prefaced it with the correct prefix field, customFlexFields.yourfield or customEntityFields.yourField.
To add a new record:
Click .
To edit or delete a record:
In the list view, select the record(s) that you want to edit or delete.
Do one of the following:
Click to edit a selected record.
Click to delete the selected record(s).
Database Backed Variforms Columns
Short Label |
Long Label |
In Filter? |
Sorting? |
---|---|---|---|
Changed |
Changed |
X |
X |
Changer |
Changer |
X |
X |
Created |
Created |
X |
X |
Creator |
Creator |
X |
X |
Description |
Description |
X |
X |
Enabled |
Enabled |
X |
X |
Level |
Level |
X |
X |
Name |
Name |
X |
X |
Scope |
Scope |
X |
|
Variform IDs |
Variform IDs |
X |
|